home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_300 / 305_02 / sample.doc < prev    next >
Encoding:
Text File  |  1990-02-12  |  10.0 KB  |  262 lines
  1. This document describes a sample session with Emandel and Emdisplay. 
  2. I ask that you read the full documentation MANDEL.DOC before 
  3. attempting to run Emandel. Then print out a copy of this file and 
  4. follow the step-by-step instructions for a complete "tour" of the 
  5. highways and byways of Emandel and Emdisplay. You should also print 
  6. out a copy of CMDS.TXT, which is a brief summary of the commands 
  7. available in Emandel.
  8.  
  9. Start Emandel by typing the following line at the DOS prompt:
  10.  
  11. EMANDEL  -1.7186  0.0041  -0.0041  /S.2  /B3
  12.  
  13. Be sure you type the line exactly as above. When you see the word 
  14. "Working." appear on the bottom line, press ^S (control-S). This 
  15. will blank the screen. You can now wait for the computer to beep, to 
  16. tell you it has finished calculating. (This will take about 9 1/2 
  17. minutes on a 10 MHz AT clone with a math co-processor chip, but may 
  18. take an hour or more on a slow PC without a math chip.) 
  19.  
  20. If you look very closely, you will see a tiny dot moving down the 
  21. screen. This shows you the progress of the calculation.
  22.  
  23. You may wish to check progress more closely from time to time before 
  24. calculation is done. Press ^S again to restore the screen. Actually, 
  25. in this particular picture there will be nothing to see until it is 
  26. about 2/3 done, at which time a small speck will appear, and then 
  27. nothing more until it is finished. This is because I have selected a 
  28. frame with mostly low-value pixels for a quick sample session.
  29.  
  30. You will know you have restored the screen, in the absence of an 
  31. image, because the prompt line will appear, unless you have erased 
  32. it. Now type ?t and then type ?% (letter commands may be upper case 
  33. or lower case.) The first will tell you the elapsed time and 
  34. (possibly) the estimated remaining time in brackets. The second will 
  35. tell you what percentage of the frame is finished. You may press ^S 
  36. to blank the screen again.
  37.  
  38. If you are out of earshot of the computer, and you want to know if 
  39. it has finished yet, un-blank the screen with ^S and look for the 
  40. words "Calculation completed." in the bottom line.
  41.  
  42. AFTER CALCULATION IS FINISHED THE FUN BEGINS:
  43.  
  44. Unblank the screen with ^S if you have not already done so.
  45.  
  46. Press ^T (control-T) to enter Threshview mode.
  47.  
  48. At the "Cluster?" prompt enter A <CR> 
  49.  
  50. At the "Auto-draw. First cluster?" prompt press <CR>
  51. At the "Last cluster?" prompt again just press <CR>
  52. At the "Start value?" prompt enter 2 <CR>
  53. At the "Size?" prompt press <CR>
  54. At the "Gap?" prompt press <CR>
  55. At the "Stop value?" prompt press <CR>
  56.  
  57. And before your eyes, a picture will appear. Next:
  58.  
  59. At the "Cluster?" prompt enter W <CR>
  60.  
  61. and the picture will be written to a file, and the prompt line will 
  62. tell you its file name and ask you to press any key. So press any 
  63. key and you will get the "Cluster?" prompt again. Now:
  64.  
  65. Enter A <CR>
  66. At the "Auto-draw. First cluster?" prompt press <CR>
  67. At the "Last cluster?" prompt again just press <CR>
  68. At the "Start value?" prompt enter 2 <CR>
  69. At the "Size?" prompt press <CR>
  70. At the "Gap?" prompt enter 3 <CR>
  71. At the "Stop value?" prompt press <CR>
  72.  
  73. A new picture will appear. Again:
  74.  
  75. At the "Cluster?" prompt enter W <CR>
  76.  
  77. And then press any key when you are asked to. Next:
  78.  
  79. At the "Cluster?" prompt enter 100 <CR>
  80.  
  81. The program will tell you that cluster 100 is clear and ask you for 
  82. a new bottom value. Enter 25 <CR>
  83.  
  84. The program will ask you for a new top value. Press the "less than" 
  85. sign (<), which is the same as the comma key, and then <CR>
  86.  
  87. And the picture will change again. At the "Cluster?" prompt enter W 
  88. <CR> again to write this third picture to a file.
  89.  
  90. Now press ESC to exit from Threshview mode.
  91.  
  92. Now press ^W (control-W) to write the data to a file, in case you 
  93. want to play with this file again before erasing it.
  94.  
  95. Now press ^C (control-C) to exit from Emandel.
  96.  
  97. NOW IT IS TIME TO USE EMDISPLAY
  98.  
  99. Start the program Emdisplay by typing at the DOS prompt:
  100.  
  101. EMDISPLAY
  102.  
  103. Or, if your printer is connected to LPT2 type instead:
  104.  
  105. EMDISPLAY /2
  106.  
  107. NOTE: There is no point in trying to print if your printer is not 
  108. Epson compatible, or if it is a daisy-wheel printer. But you can 
  109. still use Emdisplay to view pictures without printing.
  110.  
  111. Now the first of your pictures will show on the screen. Press the 
  112. space bar to see the next one. Or press B to see the previous one. 
  113. You can scroll around and around, forward or backward, as long as 
  114. you like. 
  115.  
  116. If you wish to print one of the pictures, turn your printer on, put 
  117. a sheet of paper in it, align the top of the paper with the top of 
  118. the ribbon, and then press P. Because the pictures you just made are 
  119. small, there will be a lot of blank paper. The picture will be 
  120. printed in the middle of the paper with the title line at the 
  121. bottom. (As seen after it is done. While printing it is sideways.)
  122.  
  123. When you are finished, press X to exit from Emdisplay.
  124.  
  125. Now you have gone through your first session with Emandel and 
  126. Emdisplay, and you are ready to make the picture of the whole 
  127. Mandelbrot set. You will use this one later as a guide as you 
  128. explore its inner recesses.
  129.  
  130. -------------------------------------------
  131.  
  132. MAKING THE FILE "WHOLE.PIK"
  133.  
  134. This one will take longer. About 40 minutes on my 10 MHz AT clone 
  135. with a 10 MHz math co-processor chip. Perhaps all night on a slow XT 
  136. with no math chip. So you will want to run it when the computer has 
  137. nothing better to do. 
  138.  
  139. So, when you are about to go to bed, or are not going to be using 
  140. the computer for a few hours, run the batch file WHOLE.BAT by typing
  141.  
  142. WHOLE
  143.  
  144. at the DOS prompt. When you see the "Working." prompt, press ^S to 
  145. blank the screen.
  146.  
  147. When you get up in the morning press ^S to un-blank the screen. If 
  148. "Calculation completed" appears on the bottom line you may proceed 
  149. as above to make pictures. (REMEMBER TO USE ^W TO SAVE THE DATA 
  150. FILE. You will use this one as a basis for future sessions. See the 
  151. instructions for Grid mode in MANDEL.DOC.) Otherwise:
  152.  
  153. Press ^Q to quit calculation. ("Calculation halted" will now appear 
  154. on the bottom line.)
  155.  
  156. Press ^W to write the data file. (The bottom line will say 
  157. "Saving..." while it writes to disk, and will say "Saved" when it is 
  158. done.) If the frame is well-along in its calculation, this file-
  159. write will take some time. It is a BIG file. A full data file takes 
  160. 15 seconds to write or read on a 28 ms. hard disk running in a fast 
  161. AT clone. If you are using a floppy disk (*** NOT RECOMMENDED! ***) 
  162. it may take 5 or 10 minutes.
  163.  
  164. Once the file is saved, press ^C to exit the program. 
  165.  
  166. The data file is named WHOLE.PIK because that name was given on the 
  167. command line (in the batch file WHOLE.BAT).
  168.  
  169. When you are ready to resume work on the frame, run Emandel by 
  170. typing at the DOS prompt:
  171.  
  172. EMANDEL  WHOLE
  173.  
  174. Do not run the batch file WHOLE.BAT again unless you have lost 
  175. WHOLE.PIK and want to produce it again from scratch. 
  176.  
  177. You can halt the program, save the data file, and then re-start the 
  178. program as many times as you like, until it is finished. And after 
  179. it is finished, you can re-start it again using the completed data 
  180. file, in order to make more pictures with Threshview or to use Grid 
  181. to create new batch files.
  182.  
  183. -------------------------------------------
  184.  
  185. A SAMPLE SESSION WITH GRID MODE.
  186.  
  187. After WHOLE.PIK is finished, if you are not still in Emandel, run it 
  188. with the command line:
  189.  
  190. EMANDEL  WHOLE
  191.  
  192. And when you see "Calculation completed" on the prompt line press ^T 
  193. to enter threshview mode. 
  194.  
  195. At the "Cluster?" prompt enter A <CR>
  196. At the "Auto-draw. First cluster?" prompt press <CR>
  197. At the "Last cluster?" prompt again just press <CR>
  198. At the "Start value?" prompt enter 7 <CR>
  199. At the "Size?" prompt press <CR>
  200. At the "Gap?" prompt press <CR>
  201. At the "Stop value?" prompt press <CR>
  202.  
  203. The screen will re-draw. Wait for it to complete. You will now see 
  204. the narrow "halo" that surrounds the Mandelbrot set. It is this halo 
  205. around the set that contains all the interesting patterns you will 
  206. want to explore.
  207.  
  208. Now press ^G to enter Grid mode. 
  209.  
  210. Press * (the asterisk) to increase hair-line speed.
  211.  
  212. Use the number pad keys to move the hairline to the region of the 
  213. halo. Remember that the 5 key stops movement if you are in glide 
  214. mode.
  215.  
  216. Press ^B to open a grid box.
  217.  
  218. Press <BS> to set motion speed to its minimum.
  219.  
  220. Use the number pad keys to position the grid box onto some part of 
  221. the halo. 
  222.  
  223. Press # (the crosshatch) to tell Emandel to create a batch file.
  224.  
  225. At the "Enter PIK file name" prompt, enter a file name of your 
  226. choice (it must be a valid DOS file name of 8 letters or less, and 
  227. should not have a file type extension) or else just press <CR>
  228.  
  229. At the "Maxit?" prompt enter 255.
  230.  
  231. At the "Size" prompt enter 1 unless your computer's memory is 
  232. limited or you wish to save time by using a small frame size. If you 
  233. enter 0.25 the picture will be half the height and half the width of 
  234. the full screen.
  235.  
  236. Now the program will tell you the name of the batch file, such as 
  237. "EMAND0.BAT". Remember this name.
  238.  
  239. Now press ESC to exit from Grid mode and ESC again to exit from 
  240. Threshview mode.
  241.  
  242. IF YOU HAVE NOT ALREADY SAVED WHOLE.PIK PRESS ^W TO DO SO NOW. If 
  243. the file WHOLE.PIK was complete before you entered Emandel this 
  244. session, then you do not need to save it again.
  245.  
  246. Press ^C to exit from Emandel. If you have not saved WHOLE.PIK, 
  247. Emandel will tell you "file not saved. Exit?" Press Y if you already 
  248. have a completed copy of WHOLE.PIK on disk. If you have in fact 
  249. forgotten to save WHOLE.PIK press N. Then, when the prompt says 
  250. "Well okay then..." press ^W and when the save is completed press ^C 
  251. to exit from the program.
  252.  
  253. When you are ready to run Emandel again, type the batch file name at 
  254. the DOS prompt (without the "BAT" extension:)
  255.  
  256. EMAND0
  257.  
  258. This batch file (created in the above session) will run Emandel and 
  259. produce the frame you marked for enlargement. The batch file will 
  260. automatically delete itself if the program terminates without 
  261. errors.
  262.